Release 2.3.0 for azure-ai-agents and azure-ai-projects by kaylieee · Pull Request #49951 · Azure/azure-sdk-for-java

kaylieee · 2026-07-28T00:57:02Z

This pull request introduces several preview tool classes and updates API documentation in the Azure AI Agents SDK. The main changes are the addition of new preview tool annotations, improvements to the API JavaDoc comments for clarity, and the inclusion of a new optional status field in the instance_identity object throughout the API documentation.

Preview tool support and annotation updates:

Added multiple new preview tool classes (e.g., A2APreviewTool, BingCustomSearchPreviewTool, BrowserAutomationPreviewTool, MicrosoftFabricPreviewTool, SharepointPreviewTool, WorkIqPreviewTool, etc.) with corresponding Preview API. preview_tool annotations in beta-annotations.csv. [1] [2] [3]

API documentation improvements:

Updated the JavaDoc for methods in AgentsAsyncClient.java to clarify that the content parameter is "The content multipart request content" instead of just "The content parameter". [1] [2] [3] [4] [5]
Improved the session creation JavaDoc to specify that session ownership is enforced using the provided user identity (instead of isolation key).

Instance identity enhancements:

Added an optional status field (with possible values active or disabled) to the instance_identity object in the API documentation for agent creation, update, and related methods. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

These changes improve the SDK's preview tool coverage, clarify API usage for developers, and add flexibility for agent instance identity management.

Copilot

Pull request overview

This PR updates the Azure AI Agents and Azure AI Projects Java SDKs for the 2.3.0 release, primarily by expanding preview tool coverage/annotations, improving generated JavaDoc to better reflect request/response shapes, and aligning clients/samples with updated service behaviors (notably data-generation LROs and new evaluation warning payloads).

Changes:

Added/expanded preview tool model types and corresponding beta annotations (including toolbox tool type additions).
Updated data generation job creation to use long-running operation pollers and adjusted samples/tests accordingly.
Introduced new evaluation warning models and surfaced them on evaluator-related resources; improved generated JavaDoc wording across multiple clients/impls.

Reviewed changes

Copilot reviewed 106 out of 108 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
sdk/ai/azure-ai-projects/tsp-location.yaml	Updates TypeSpec source commit and consolidates OpenAI directories into `openai`.
sdk/ai/azure-ai-projects/src/test/java/com/azure/ai/projects/DataGenerationJobsClientTests.java	Updates test to use `beginCreateGenerationJob(...).poll().getValue()` and removes `allowPreview(true)` usage.
sdk/ai/azure-ai-projects/src/test/java/com/azure/ai/projects/DataGenerationJobsAsyncClientTests.java	Updates async test to use `beginCreateGenerationJob(...).next()` and removes `allowPreview(true)` usage.
sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/SkillsPackageSample.java	Adjusts skill zip packaging and sets uploaded skill version as default.
sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobWithEvaluationSample.java	Switches to LRO-based data generation job creation and removes `allowPreview(true)`.
sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobsSample.java	Updates sample to create jobs via LRO poller; adjusts sample job options.
sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobsAsyncSample.java	Updates async sample to create jobs via LRO poller; adjusts sample job options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/TaskGenerationDataGenerationJobOptions.java	Adds new preview job options model for `task_generation` data generation jobs.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningSource.java	Adds extensible enum for rubric input-quality warning source.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningSeverity.java	Adds extensible enum for rubric input-quality warning severity.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningCode.java	Adds extensible enum for rubric input-quality warning codes.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarning.java	Adds model representing rubric-generation input-quality advisories.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/HumanEvaluationPreviewRuleAction.java	Marks rule action model as preview via `@Beta`.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/GenerationWarningType.java	Adds extensible enum for warning categories on generated evaluator versions.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/EvaluatorVersion.java	Surfaces generation provenance (`generation_job_id`) and warning categories on evaluator versions.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/EvaluatorGenerationJob.java	Adds `input_quality_warnings` list to evaluator generation jobs.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobType.java	Adds `TASK_GENERATION` job type constant.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobOptions.java	Adds discriminator support for `task_generation` options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/SyncOperationLocationPollingStrategy.java	Adds generated sync polling strategy for Operation-Location based LROs.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/PollingUtils.java	Adds generated polling utilities for retry-after parsing and deserialization.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/OperationLocationPollingStrategy.java	Adds generated async polling strategy for Operation-Location based LROs.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/DeploymentsImpl.java	Improves generated JavaDoc wording (“Retrieves…”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/DatasetsImpl.java	Improves generated JavaDoc wording and casing (“dataset version”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaSkillsImpl.java	Clarifies multipart `content` parameter JavaDoc.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaModelsImpl.java	Improves model-version operation JavaDoc wording and request-body parameter descriptions.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaEvaluationTaxonomiesImpl.java	Improves update taxonomy JavaDoc wording.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DeploymentsClient.java	Aligns JavaDoc wording with impl (“Retrieves…”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DeploymentsAsyncClient.java	Aligns JavaDoc wording with impl (“Retrieves…”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DatasetsClient.java	Aligns JavaDoc wording with impl (“Retrieves…”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DatasetsAsyncClient.java	Aligns JavaDoc wording with impl (“Retrieves…”).
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsClient.java	Clarifies multipart `content` parameter JavaDoc.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsAsyncClient.java	Clarifies multipart `content` parameter JavaDoc.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaModelsClient.java	Aligns JavaDoc wording with impl for model version operations.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaModelsAsyncClient.java	Aligns JavaDoc wording with impl for model version operations.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaEvaluationTaxonomiesClient.java	Improves update taxonomy JavaDoc wording.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaEvaluationTaxonomiesAsyncClient.java	Improves update taxonomy JavaDoc wording.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaDatasetsClient.java	Reworks data-generation create into LRO (`beginCreateGenerationJob`) and updates job option docs.
sdk/ai/azure-ai-projects/customizations/beta-annotations.csv	Adds preview annotations for newly introduced evaluation and data-generation models.
sdk/ai/azure-ai-agents/tsp-location.yaml	Updates TypeSpec source commit and consolidates OpenAI directories into `openai`.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsAsyncSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamAsyncSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesAsyncSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointAsyncSample.java	Removes unnecessary `allowPreview(true)` for beta clients.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesClient.java	Updates tool type documentation to include `toolbox_search` alongside preview variant.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesAsyncClient.java	Updates tool type documentation to include `toolbox_search` alongside preview variant.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/WorkIqPreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/WorkIqPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolSearchToolboxTool.java	Adds new toolbox tool model for non-preview `toolbox_search`.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxToolType.java	Adds enum value `TOOLBOX_SEARCH`.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxTool.java	Adds discriminator support for `toolbox_search`.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxSearchPreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolParameters.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ReminderPreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationOptions.java	Adds `max_stalls` option field with JSON serialization/deserialization.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MicrosoftFabricPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemorySearchToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemorySearchPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemoryCommandToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemoryCommandToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricIqPreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricIqPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolParameters.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CreateAgentVersionInput.java	Narrows preview annotation scope to specific fields instead of the whole model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolParameters.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolConnectionParameters.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationPreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolParameters.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchPreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchConfiguration.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureUserSecurityContext.java	Adds model for end-user security context (Defender for Cloud integration).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureFunctionToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureCreateResponseOptions.java	Adds `user_security_context` field with JSON serialization/deserialization.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentIdentityStatus.java	Adds extensible enum for agent identity status (`active`/`disabled`).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentIdentity.java	Adds `status` field to agent identity JSON model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDefinition.java	Removes preview annotation from the entire type (reduces over-scoping).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2AToolCallOutput.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2AToolCall.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2APreviewToolboxTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2APreviewTool.java	Adds `@Beta` preview-tool annotation.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/ToolboxesImpl.java	Updates tool type documentation to include `toolbox_search` alongside preview variant.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/AgentsImpl.java	Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClient.java	Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsAsyncClient.java	Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording).
sdk/ai/azure-ai-agents/customizations/beta-annotations.csv	Adds preview-tool and field-level beta annotations for newly introduced preview surface.

jpalvarezl

This is looking great and I am really happy we are surfacing LROs the right way. Not sure if there are still some ops that need to be migrated that weren't LROs but should have been, but I am happy to see that things are flagged the right way in the upstream spec.

kaylieee added 6 commits July 20, 2026 17:16

regen projects

de9bc02

regen agents

e2abd21

update samples and tests

0ddf0a8

sample and test fixes

218ee19

regen agents and projects

781bd80

add new beta decorators

ed03f4e

Copilot AI review requested due to automatic review settings July 28, 2026 00:57

kaylieee requested review from a team, dargilco, glecaros, jpalvarezl and trrwilson as code owners July 28, 2026 00:57

github-actions Bot added AI Agents AI Projects labels Jul 28, 2026

Copilot started reviewing on behalf of kaylieee July 28, 2026 00:57 View session

Copilot AI reviewed Jul 28, 2026

View reviewed changes

jpalvarezl reviewed Jul 28, 2026

View reviewed changes

Comment thread sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2AToolCall.java

jpalvarezl reviewed Jul 28, 2026

View reviewed changes

kaylieee and others added 12 commits August 3, 2026 21:52

Merge branch 'main' into kaylieee/release/2.3.0

142eb36

regen

1b47978

temp disable

ebd49aa

regen

99e228d

regen spacing

6ed1ac8

temp disable

eca5b89

rename and preview decorator update

fdbf3db

update versioning

51a8279

remove unnecessary polling injection

dc5e239

Merge branch 'main' into kaylieee/release/2.3.0

03779db

update version client txt

7ca7be7

regen spacing

1824bf6

Navigation Menu

Uh oh!

Release 2.3.0 for azure-ai-agents and azure-ai-projects - #49951

Release 2.3.0 for azure-ai-agents and azure-ai-projects#49951
kaylieee wants to merge 18 commits into
mainfrom
kaylieee/release/2.3.0

kaylieee commented Jul 28, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jpalvarezl left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

kaylieee commented Jul 28, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jpalvarezl left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants